home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 201-220 / scopedisk212 / flit / flit.man < prev    next >
Text File  |  1995-03-19  |  4KB  |  109 lines
  1.                             FliT Documentation 
  2.  
  3. Program:
  4.     FliT 1.0.
  5.  
  6. Purpose:
  7.     Convert Autodesk Animator .FLI animations to IFF ANIMs. .FLI animations
  8.     are found on PClones.
  9.  
  10. Author:
  11.     John Bickers (JJB Templar)  - jbickers@templar.actrix.gen.nz
  12.  
  13.     Public Domain DLTA 5 compression code by Jim Kent (Fish 185).
  14.  
  15. Credits:
  16.     This was written using Lattice C 5.10a.
  17.  
  18.     Jim Kent's "skip.c" module from AmigaLibDisk #185 is used to do
  19.     the compression of DLTA chunks in the IFF ANIM files FliT creates.
  20.  
  21.     The format of a .FLI file was obtained from an article posted to
  22.     Usenet's comp.graphics by Kevin Darling (kdarling@hobbes.ncsu.edu).
  23.  
  24.     Neither of the above is aware of, or had any other part in the
  25.     development of, this program. That is, the bugs and brute force are
  26.     mine. :)
  27.  
  28. Command line options:
  29.     A summary of these options can be accessed with "flit ?".
  30.  
  31.     -m[file]    Make an IFF ANIM file. The [file] parameter is optional,
  32.                 and if not given the file "ram:flit.anim" will be used.
  33.  
  34.     -p          Pause between frames. Press Space or click the left
  35.                 mouse button to proceed to next frame. .FLIs often
  36.                 contain filler frames, so the display may not change,
  37.                 even though the frame will have.
  38.  
  39.     -v          Be verbose. Various bits of information I found useful
  40.                 when writing the program. Now excessive.
  41.  
  42.     -g          Use a gray color map. This should be used on animations
  43.                 that have more than 16 colors. It happened to be the
  44.                 easiest way me to get something acceptable from larger
  45.                 colormaps. :) No dithering, HAM, or other baggage. :)
  46.  
  47.     -j[m[/d]]   Jiffy modifiers. The .FLI jiffy value will be multiplied
  48.                 by this fraction. For example, "-j2" would slow the
  49.                 final animation down by a factor of two. "-j4/2" would
  50.                 do the same.
  51.  
  52. Miscellaneous:
  53.     Premature termination:
  54.         When running, the program can be terminated by pressing Esc in
  55.         the display screen. If you used the -m option, the ANIM file
  56.         will be completed.
  57.  
  58.     Playback rate:
  59.         Is based purely on how fast the program can go. .FLI animations
  60.         have the data in a byte-per-pixel format that makes unpacking
  61.         slow. In addition, the -m option adds further delays. Any ANIM
  62.         file produced should play back much more smoothly.
  63.  
  64.     The Animation Loop:
  65.         If you use the -m option, then when the animation ends FliT adds
  66.         two frames to the end of the ANIM file which duplicate the
  67.         1st and 2nd frames of the animation. This allows animation
  68.         players (for example, ShowANIM -C) to loop the animation
  69.         smoothly.
  70.  
  71. To do:
  72.     Is HAM/dithering worth doing? Any other manipulations anyone's
  73.     interested in? Any bugs (I've only got a handful of .FLIs to test
  74.     with)?
  75.  
  76.     There's a fair amount of optimization one could do too...
  77.  
  78. Personal stuff:
  79.     Suggestions are welcome, and may even be implemented. I can be
  80.     contacted at the following:
  81.  
  82.     Snail:  John Bickers,
  83.             214 Rata St,
  84.             Naenae 6301,
  85.             New Zealand.
  86.  
  87.     Email:  jbickers@templar.actrix.gen.nz
  88.  
  89.     Phone:  677-334, 672-085, or 746-625.
  90.  
  91.     People who use this program are also invited to send some notification
  92.     of their existence to any of the above points. Feel free to pay
  93.     something (esp. if you want to request that something be added :) too,
  94.     but payment is not a requirement. I'd be more interested in
  95.     animations, actually (NOT NOT NOT via email! I have to pay $$ for
  96.     that!).
  97.  
  98.     This program may be redistributed freely, but not for commercial gain
  99.     (ie: Fred Fish type costs are ok). Note that you should include the
  100.     documentation.
  101.  
  102.     FliT is Copyright © 1991 by John Bickers.
  103.  
  104. History:
  105.     1.0     Begun 17-Mar-91.
  106.  
  107. Disclaimer:
  108.     "It works on my machine" (so far :).
  109.